home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / utility / sdflush.zip / SDFLUSH.DOC < prev   
Text File  |  1993-12-16  |  5KB  |  99 lines
  1.  
  2.                                 JP Software
  3.  
  4.                            SDFLUSH Documentation
  5.  
  6.                       Version 1.0 -- December 16, 1993
  7.  
  8.  
  9. Copyright 1993, JP Software Inc., All Rights Reserved.  Published by JP
  10. Software Inc., P.O. Box 1470, E. Arlington, MA 02174 USA, (617) 646-3975,
  11. fax (617) 646-0904.
  12.  
  13.  
  14. This file explains how to use SDFLUSH, JP Software's TSR utility for use
  15. with 4DOS and SMARTDRV.
  16.  
  17. Microsoft's SMARTDRV disk cache program offers a "delayed write" or
  18. "write-behind" mode.  In this mode, data written to disk is held in the
  19. cache (in memory) until the system is idle (or until the cache memory area
  20. is full), at which point the data is physically written to the disk.
  21.  
  22. This approach can improve performance, but it can also be dangerous -- for
  23. example, if you wait for the prompt and then turn off the computer, there
  24. may be data in the cache which has not yet been written to disk.
  25.  
  26. Under PC-DOS 6.1 and MS-DOS 6.2, COMMAND.COM attempts to minimize this
  27. danger by instructing SMARTDRV to write all cached data to the disk before
  28. the command prompt is displayed.
  29.  
  30. 4DOS does not currently interact with SMARTDRV in this way. However, if you
  31. wish to enable this behavior under 4DOS you can do so with SDFLUSH.
  32.  
  33. SDFLUSH is a TSR which watches for a signal from 4DOS indicating that 4DOS
  34. is about to display a prompt.  It then sends the appropriate signals to
  35. instruct SMARTDRV to write cached data to the disk.  It does not allow 4DOS
  36. to display the prompt until it receives an indication from SMARTDRV that
  37. there is no more data waiting to be written to the disk.
  38.  
  39. Note that you do NOT need SDLFUSH unless (a) you are using SMARTDRV from
  40. MS-DOS or PC-DOS version 6 or later, (b) SMARTDRV is running in
  41. delayed-write mode, and (c) you wish to force cache data to be written to
  42. disk before each prompt is displayed.
  43.  
  44. To use SDFLUSH, simply load it with a command like this:
  45.  
  46.       c:\> c:\4dos\sdflush
  47.  
  48. Normally you would place this command in AUTOEXEC.BAT or otherwise load it
  49. when your system boots.  SDFLUSH should be loaded after SMARTDRV.  It can
  50. be loaded high with the LH command or other similar utilities if you wish. 
  51. SDFLUSH uses 336 bytes when resident in memory.
  52.  
  53. SDFLUSH cannot unload itself, but you can unload it with MARK and RELEASE
  54. from the TSRCOM utility package (available on-line or on the 4DOS Utility
  55. Disk from JP Software), or other similar TSR management utilities.
  56.  
  57. SDFLUSH works with PC-DOS 6.1 and MS-DOS 6.2 as described above. In
  58. addition, SDFLUSH will work with MS-DOS 6.0 SMARTDRV.  You may find this to
  59. be an improvement over MS-DOS 6.0 COMMAND.COM, which does not offer a
  60. similar feature.
  61.  
  62. SDFLUSH is designed for use with 4DOS 5.0 and above, along with SMARTDRV
  63. for MS-DOS / PC-DOS version 6.x.  If you do not have both 4DOS and SMARTDRV
  64. loaded, there is no point in loading SDFLUSH.  SDFLUSH may work properly
  65. with SMARTDRV from MS-DOS / PC-DOS version 5, and with 4DOS version 4, but
  66. it has not been tested in those environments.
  67.  
  68. Some other cache software responds to the same signals as SMARTDRV and may
  69. therefore work properly with SDFLUSH, but we have not tested such
  70. combinations and cannot guarantee the results.
  71.  
  72. CAUTION:  USING ANY CACHE PROGRAM IN DELAYED WRITE MODE CAN REDUCE THE
  73. INTEGRITY OF YOUR SYSTEM.  If you use SMARTDRV or any other cache program
  74. in delayed write mode we STRONGLY encourage you to use your own methods to
  75. ensure that the cache is empty prior to rebooting or shutting down your
  76. system, defragmenting your hard disk, or disabling your cache.  Such
  77. methods might include issuing the appropriate "flush buffers" command for
  78. your cache software (for example, the SMARTDRV /C command), or observing
  79. the disk activity light for an appropriate period of time to ensure that
  80. activity has ceased.
  81.  
  82. JP Software cannot guarantee that SDFLUSH will provide additional safety on
  83. your particular system.  SDFLUSH is a relatively simple program and we
  84. expect it to work reliably.  We have tested it with SMARTDRV under MS-DOS
  85. 6.0 and 6.2 and found that it does delay display of the prompt until cached
  86. writes are completed.  However this behavior may change due to interaction
  87. with other memory-resident programs, updates to SMARTDRV, and any SMARTDRV
  88. configuration options you select.  Therefore you may wish to use the
  89. additional methods as described above to help ensure that cached data is
  90. written to disk when such assurance is required.
  91.  
  92. DISCLAIMER:  THIS SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY
  93. KIND.  IN NO EVENT SHALL WE BE LIABLE FOR ANY INCIDENTAL, CONSEQUENTIAL, OR
  94. PUNITIVE DAMAGES WHATSOEVER ARISING OUT OF USE OF THIS PROGRAM.
  95.  
  96. SDFLUSH is distributed free of charge by JP Software, and may be
  97. redistributed freely, as long as this documentation and the program itself
  98. are included with all copies, and have not been altered in any way.
  99.